package com.hdwe.tools.pm.service;

import com.hdwe.tools.pm.domain.bo.PmTaskBo;
import com.hdwe.tools.pm.domain.vo.PmTaskVo;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;

import java.util.Collection;
import java.util.List;

/**
 * 任务Service接口
 *
 * @author Lion Li
 * @date 2024-12-09
 */
public interface IPmTaskService {

    /**
     * 查询任务
     *
     * @param id 主键
     * @return 任务
     */
    PmTaskVo queryById(Long id);

    /**
     * 分页查询任务列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 任务分页列表
     */
    TableDataInfo<PmTaskVo> queryPageList(PmTaskBo bo, PageQuery pageQuery);

    /**
     * 查询符合条件的任务列表
     *
     * @param bo 查询条件
     * @return 任务列表
     */
    List<PmTaskVo> queryList(PmTaskBo bo);

    /**
     * 查询我负责的任务列表
     *
     * @return 任务列表
     */
    TableDataInfo<PmTaskVo> queryMyTasks(Long userId, PageQuery pageQuery);

    /**
     * 查询我相关的任务列表
     *
     * @return 任务列表
     */
    TableDataInfo<PmTaskVo> queryMyRelatedTasks(Long userId, PageQuery pageQuery);

    /**
     * 查询日报任务列表
     * 条件：负责人为当前用户，修改时间=当天
     *
     * @return 任务列表
     */
    List<PmTaskVo> queryDailyReport(Long userId);

    /**
     * 查询当天我需要处理的任务列表
     * 条件：
     * 1、负责人为当前用户
     * 2、开始时间=当天
     * 3、开始时间<当天，状态!=完成
     *
     *
     * @return 任务列表
     */
    List<PmTaskVo> queryDailyWork(Long userId);

    /**
     * 查询我本周负责的任务列表
     *
     * @return 任务列表
     */
    List<PmTaskVo> queryWeeklyTasks(Long userId);

    /**
     * 查询里程碑的任务列表
     *
     * @return 任务列表
     */
    List<PmTaskVo> queryMilestoneTasks(Long milestoneId);

    /**
     * 查询需求的任务列表
     *
     * @return 任务列表
     */
    List<PmTaskVo> queryRequireTasks(Long requireId);

    /**
     * 查询需求的任务完成率
     *
     * @return 任务完成率
     */
    long queryRequireFinishedRate(Long requireId);

    /**
     * 查询被阻塞的任务列表
     *
     * @return 任务列表
     */
    List<PmTaskVo> queryBlockedTasks(Long requireId);

    /**
     * 新增任务
     *
     * @param bo 任务
     * @return 是否新增成功
     */
    Boolean insertByBo(PmTaskBo bo);

    /**
     * 修改任务
     *
     * @param bo 任务
     * @return 是否修改成功
     */
    Boolean updateByBo(PmTaskBo bo);

    /**
     * 校验并批量删除任务信息
     *
     * @param ids     待删除的主键集合
     * @param isValid 是否进行有效性校验
     * @return 是否删除成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 批量新增需求
     *
     * @param boList 需求
     * @return 是否新增成功
     */
    Boolean batchInsertByBo(List<PmTaskBo> boList);

}
